home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / giochi / gpdispl1.lha / GPDisplay.doc < prev    next >
Text File  |  1995-10-03  |  8KB  |  260 lines
  1.                               -----------------
  2.                                GPDisplay V0.02
  3.                             ---------------------
  4.  
  5.                          Public Release Beta Version
  6.  
  7.                                 3 October 1995
  8.  
  9.                                 by Grant Reeve
  10.                            reeve1@cs.waikato.ac.nz
  11.  
  12.  
  13. ABOUT THIS VERSION
  14. ------------------
  15.  
  16. I finally got sick of not releasing this software, and people keep asking for
  17. copies to play with, so I decided to release the current version I am up to in
  18. development, to let everyone be happy.  When my exams and other uni stuff
  19. finish soon, I will then be able to sit down and produce a nice proper full
  20. release version.  This full version will be shareware (probably about 5 UKP
  21. registration), but completely uncrippled for those of you who can't part with
  22. any of your precious money ;)
  23.  
  24.  
  25. OVERVIEW
  26. --------
  27.  
  28. This program will display perf files saved from AGPPerf, or directly from
  29. AGPPerfs memory.  It allows comparison and analysis of up to 4 perf files at
  30. once, plus it has some (very) rudimentary editing facilities.
  31.  
  32.  
  33. USAGE
  34. -----
  35.  
  36. Run GPDisplay from a CLI, with up to 4 perf files on the command line, or from
  37. WorkBench.
  38.  
  39. GPDisplay [noactivate] [file1] [file2] ... [file3]
  40.  
  41. noactivate
  42.   This tells GPDisplay to open it's screen behind everything else, so that it
  43. won't interrupt anything else you might be doing (like loading F1GP)
  44.  
  45. file1
  46.   This should be a valid perf file. If it is not, an appropriate error message
  47. will tell you you're an idiot. :) You can actually specify a number from 0 to
  48. 15, and GPDisplay will load the track data for that particular track.
  49.  
  50. file?
  51.   If you specify "memory" for any of the 4 filenames, GPDisplay will attempt
  52. to load this perf file directly from AGPPerfs memory.  This, of course, will
  53. only work when AGPPerf is running too.  It makes a COPY of AGPPerfs memory, so
  54. once you have grabbed the perf file, you can then continue to do whatever you
  55. like with AGPPerf, without damaging the perf file you copied.
  56.  
  57.  
  58. Once the program is running, you should see a screen with 3 windows on it:
  59.  
  60. Graphs window
  61. -------------
  62.  
  63. This window shows some graphs. Funny, that.
  64.  
  65. Speed
  66.   This is a graph of the cars speed. The bottom of the graph is 0 kph, the
  67. horizontal lines are in 100 kph steps. This graph is scaled automatically so
  68. that the top is either 300 kph, or whatever the highest speed is that is
  69. reached if it's above 300 kph. If you select mph, then the minimum top will be
  70. 200 mph, and the steps will be 100 mph.
  71.  
  72. RPM
  73.   This is a graph of the cars rpm. The bottom line is 7000 rpm, and the other
  74. line is 13000 rpm. the graph is scaled automatically so that the top is either
  75. 14000 rpm, or whatever the highest rpm is that is reached if it's above 14000
  76. rpm.
  77.  
  78. Gears
  79.   This is a graph of the cars gears. The bottom line is Neutral, and the top
  80. line is 6th. 1st to 5th gears are in between. Reverse is under the bottom
  81. line, and Spin gear is above the top line.
  82.  
  83. Time
  84.   This is the time differential graph. If you have more than one perf file,
  85. then this graph shows the time difference between the perf files at any
  86. particular segment. Whatever perf file is ahead at a segment, is at the bottom
  87. line. Other perf files are above that line depending on how far behind they
  88. are at that segment. The horizontal lines are in .1 second increments if the
  89. maximum time difference reached is less than 1 second, and in 1 second
  90. increments if the maximum time difference is greater than 1 second. The
  91. maximum difference displayable is 10 seconds. The maximum minimum difference
  92. is .1 seconds. This graph is also autoscaled.
  93.  
  94. Info Window
  95. -----------
  96.  
  97. This window shows more specific info about a perf file. On the left side, it
  98. shows the cars setup plus other info from the perf files header. On the right
  99. it shows info about the current segment.
  100.  
  101. Overall Perf File Info:
  102.  
  103.   file:
  104.     This is the file name.
  105.  
  106.   car:
  107.     This is the car number.
  108.  
  109.   [flaps]
  110.     These are the flap settings of the car.
  111.  
  112.   [gears]
  113.     These are the gear ratios.
  114.  
  115.   tyres:
  116.     These are one of the following: A,B,C,D,Q,W
  117.  
  118.   HP:
  119.     This is the horse power the recording was made at.
  120.  
  121.   best:
  122.     This is the best lap time in the whole perf file.
  123.  
  124. Segment Info:
  125.  
  126.   inp:
  127.     User inputs as the car crossed the segment.
  128.      A=acellerate, B=brake, L=left, R=right.
  129.  
  130.   spd:
  131.     The cars speed at this segment, in kph.
  132.  
  133.   rpm:
  134.     The cars rpm.
  135.  
  136.   gr:
  137.     The gear the car is in.
  138.  
  139.   seg:
  140.     The number of the current segment. Pit segments start are labelled "pit".
  141.  
  142.   ?:??.???
  143.     Current lap time at the start of the segment.
  144.  
  145.  
  146. Map Window
  147. ----------
  148.  
  149. This window shows the track map, with the perf files plotted in too. The track
  150. outline is drawn in black, and so is the start line and curbs. The current
  151. segment edge that is being looked at is drawn accross the track in white. If
  152. you select "show dir arrow", then a line will extend from the highlighted
  153. segments center to the center of the next segment, so you can see the
  154. direction of forwards. The line in the window-highlight colour around the
  155. track is F1GPs best line, the one you see if you use the best-line help/cheat
  156. in F1GP. The perf files are then drawn in too.
  157.  
  158.  
  159. Keys and Mouse functions
  160. ------------------------
  161.  
  162. esc - quit
  163.   Quits.
  164.  
  165. 1, 2, 3, 4 - select a perf
  166.   These keys select the 1st to the 4th perf file.
  167.  
  168. left-button in Info Window.
  169.   This will select the clicked on perf file.
  170.  
  171. a - save as
  172.   This brings up a file requestor to save the currently selected perf file.
  173.  
  174. l - load perf
  175.   This brings up a file requestor to load a perf into the current perf.
  176.  
  177. p - load pc perf
  178.   This brings up a file requestor to load a pc perf into the current perf.
  179.  
  180. m - load perf directly from AGPPerf
  181.   This will attempt to load the contents of AGPPerf into the current perf.
  182.  
  183. Del - clear perf
  184.   This clears the current perf
  185.  
  186. c - clear track
  187.   This clear everything - all perfs, and the loaded track.
  188.  
  189. F1, F2, F3, F4, F5 - select split
  190.   These keys jump the current segment to the start of the lap (F1) through to
  191. the end of the lap (F5) in quarters.  These segments are the same segments
  192. that Rene Smit's Splittime utility uses, so you can see what the split times
  193. were on a perf file.
  194.  
  195. F10 - extract best lap
  196.   This key extracts exactly the best lap out of the currently selecteed perf
  197. file, throwing away all the rest of the perf file.
  198.  
  199. left-cursor, right-cursor
  200.   These keys move the currently selected segment left or right (see highlight
  201. in Graph Window).
  202.  
  203. shift left-cursor, right-cursor
  204.   These keys move the currently selected segment left or right by 16 segments.
  205.  
  206. left-button in Graph Window
  207.   This selects the clicked on segment. Holding the button down will scroll
  208.   the selected segment around.
  209.  
  210. -/+ (on the main keyboard)
  211.   These keys change the horizontal zoom level of the graphs.
  212.  
  213. [, ] - tag start,end
  214.   These specify the start or end of a range in the perf file to the current
  215. segment. You can't see the range you select at the moment.
  216.  
  217. x - delete tag
  218.   This will delete the range you selected with [ and ].
  219.  
  220. h - hide tags
  221.   This will clear the current tags.
  222.  
  223. up-cursor, down-cursor
  224.   These keys change the current map zoom level.
  225.  
  226. keypad keys:
  227.  
  228. 7, 8, 9,
  229. 4,    6,
  230. 1, 2, 3
  231.   These keys scroll the map around in appropriate directions.
  232.  
  233. 5
  234.   This key centers the map on the current segment.
  235.  
  236. Menus
  237. -----
  238.  
  239. These should be self explanitory. The ones you can't select are ones
  240. I haven't implemented yet, or which you can't use at that point in time.
  241.  
  242.  
  243. BUGS
  244. ----
  245.  
  246. When you load a track, with NO perf files, then you can't view it.
  247.  
  248.  
  249. OTHER STUFF
  250. -----------
  251.  
  252. I wish to thank the following people, for giving me ideas and info and stuff:
  253. Rene Smit, Trevor Kellaway, Oliver Roberts, Edo Nijmeijer, Rob Buis.
  254.  
  255.  
  256. THE FUTURE
  257. ----------
  258.  
  259. * I plan on adding things.
  260.